<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Strict//EN">
<html>
<head>
<meta http-equiv="Content-Language" content="en-us">
<title>IupGLScrollBox</title>

<link rel="stylesheet" type="text/css" href="../../style.css">
<style type="text/css">
.style1 {
	font-size: large;
}
</style>
</head>
<body>
<div id="navigation">
  <ul>
    <li><a href="#Creation">Creation</a></li>
    <li><a href="#Attributes">Attributes</a></li>
    <li><a href="#Callbacks">Callbacks</a></li>
    <li><a href="#Notes">Notes</a></li>
    <li><a href="#Examples">Examples</a></li>
    <li><a href="#SeeAlso">See Also</a></li>
  </ul>
</div>

<h2>IupGLScrollBox<span class="style1"> (since 3.11)</span></h2>
<p>Creates an embedded OpenGL container that allows its child to be scrolled. It 
inherits from <a href="iupglsubcanvas.html">IupGLSubCanvas</a>. It exists only 
  inside an
<a href="iupglcanvasbox.html">IupGLCanvasBox</a>. </p>

<h3><a name="Creation">Creation</a></h3>

<pre>Ihandle* IupGLScrollBox(Ihandle*<strong> child</strong>); [in C]
iup.glscrollbox{<strong>child</strong>: ihandle} -&gt; (<strong>elem</strong>: ihandle) [in Lua]
glscrollbox(<strong>child</strong>) [in LED]</pre>
  <p><strong>child</strong>: Identifier of an interface element which will receive the 
	box. It can be NULL (nil in Lua), or empty in LED.</p>
  <p>
  <u>Returns:</u> the identifier of the 
  created element, or NULL if an error occurs.</p>

<h3><a name="Attributes">Attributes</a></h3>


<p>The 
  <strong>IupGLScrollBox</strong> element handle all attributes defined for a
<a href="iupglsubcanvas.html">IupGLSubCanvas</a> control.</p>
<p>It contains automatic scrollbars that are shown or hidden accordingly if the 
child natural size fits the client size. See the <a href="iupgl_scrollbars.html">Scrollbars Attributes for <strong>IupGLControls</strong></a> for more details.</p>
<blockquote>
  <hr>
</blockquote>



<p><a href="../attrib/iup_expand.html">EXPAND</a> (<font SIZE="3">non inheritable</font>):
  The default value is &quot;YES&quot;.</p>
<p>

	<a href="../attrib/iup_posx.html">POSX</a>:
  Position of the thumb in the horizontal 
  scrollbar. Default: "0.0". DX is the visible horizontal area and XMAX is set 
to the child natural width.</p>
<p>

	<a href="../attrib/iup_posy.html">POSY</a>:
  Position of the thumb in the vertical 
  scrollbar. Default: "0.0". DY is the visible vertical area and YMAX is set to 
the child natural height.</p>

  <blockquote>
    <hr>
</blockquote>

  <p>
  <a href="../attrib/iup_clientsize.html">CLIENTSIZE</a>, 
	<a href="../attrib/iup_clientoffset.html">CLIENTOFFSET</a>: 
also accepted.</p>

<h3>Notes</h3>
<p>The box allows the application to create a virtual space for the dialog that 
is actually larger than the visible area. The current size of the box defines 
the visible area. The natural size of the child (and its children) defines 
the virtual space size. So the <strong>IupGLScrollBox</strong> does not depend on 
its child size or expansion, and its natural size is always 0x0.</p>
<p>The user can move the box contents by dragging the background. Also the mouse 
wheel scrolls the contents vertically.</p>

<p>The box can be created with no elements and be dynamic filled using
  <a href="../func/iupappend.html">IupAppend</a> or
<a href="../func/iupinsert.html">IupInsert</a>.</p>


<h3><a name="Examples">Examples</a></h3>
<p><a href="../../examples/">Browse for Example Files</a></p>

</body>

</html>
